Plugins and Language Packs for Family Historian

Add Maps Quick Start

πŸ“ To geocode your places and addresses
  1. Open Add Maps from Tools > Plugins β€” it starts in the Geocoding view
  2. Open Options > Geocoding Options and paste in a free API key
  3. Click Geocode All (or Geocode Selected for just the ticked rows)
πŸ—ΊοΈ To build a map
  1. Switch to the Mapping view
  2. Select one or more individuals
  3. Set a folder (or turn on Temporary maps) and click Build Map(s)
🌐 To embed maps in your website
  1. Publish your Family Historian website first
  2. Open Options > Mapping Options > Website embedding and tick Embed maps in web pages
  3. Select your individuals, set Make to “A page per individual”, and click Build Map(s)
What This Plugin Does

Add Maps does three things, in order:

  • Geocodes the places and addresses in your project. It uses alternative geocoders to the one supported in Family Historian, and supports bulk geocoding of addresses (which FH doesn’t support).
  • Builds an interactive map, viewable in a browser, of where a person’s life happened.
  • Embeds those maps into a Family Historian website, if you have one β€” a live map on each person’s page.

You can stop after step 1 or step 2. Embedding is optional, and so is almost everything else: the facts included, whether to include timeline and/or witnessed facts, a journey line, a time slider, historic maps and the rest are all switches you can turn on in options and (if you enable them) toggle on the maps.

A finished Add Maps map: numbered pins joined by a journey line, tracing one person’s life
Key Terms You’ll Need To Know
Term Definition
Geocoding Finding the coordinates (latitude and longitude) of a place or address, so Add Maps can plot it
Place / address Family Historian holds both. Add Maps reads a coordinate from either, preferring the address when one has been geocoded
Standalone map A self-contained web page Add Maps writes to a folder. You open it in your browser; it needs an internet connection for the map background
Embedded map The same map, dropped into a person’s page on a Family Historian website
Base layer The background map β€” street, satellite, or an historic Ordnance Survey map. You switch between them on the map itself
API key A free key from a geocoding service (required for geocoding), or optionally from maptiler.com to unlock extra historic maps β€” see Map Keys in the Reference
Three Ways To Work

Add Maps has two views, Geocoding and Mapping, switched with the Geocoding and Mapping menus (the title bar shows which one you’re in). You can take it as far as you like β€” each way builds on the one before, and each stops somewhere useful.

πŸ“ 1 Β· Just Geocode

What it does: Lists the places (and, separately, the addresses) in your project and geocodes them β€” singly, in a batch, or the whole list β€” recording each coordinate back onto the place or address

Use when: You just want the coordinates in your project β€” the coordinates stay there and Family Historian can use them in its own map window. You geocode once, and if you’re happy with Family Historian’s own geocoding, you don’t need this step at all.

The Geocoding view in Places mode: the list with its status markers and the summary line

β†’ See Step-by-Step Guide

πŸ—ΊοΈ 2 Β· Build Maps

What it does: Choose the people you want, then Build Map(s) β€” Add Maps writes a map for each person (or one combined map for the group)

Use when: You want an interactive map you can look at in a browser β€” building several maps opens the output folder, building a single map opens it directly

The Mapping view: the chosen individuals, the Make dropdown and the Build Map(s) button

β†’ See Step-by-Step Guide

🌐 3 · Embed Maps In Your Website

What it does: Turn embedding on and Add Maps drops each person’s map into their page on a published Family Historian website

Use when: You publish a Family Historian website and want a live map on each person’s page β€” build the website first, then run Add Maps

β†’ See Step-by-Step Guide

Common Questions
Q: Do I need an account or an API key?
A: For geocoding, yes β€” a free one. Add Maps geocodes through one of three services β€” Geoapify (the default), OpenCage or LocationIQ β€” and each needs a free API key you paste into Geocoding Options. Geoapify and LocationIQ provide free tiers. OpenCage has a small cost but there is a free testing allowance and it may suit some users best. The maps themselves need no key: street, satellite and the Scottish/GB historic maps all work as they are. A MapTiler key (also a free tier) is optional and adds more GB and Ireland historic maps.
Q: Where do the maps go?
A: To the Output folder you choose in the Mapping view. When you’re embedding, that’s your website folder, and the maps go into a “maps” sub-folder of it. If you only want a quick look, turn on Temporary maps and skip the folder altogether β€” Add Maps builds them somewhere disposable and clears them out when it closes.
Q: Will it change my project or my website?
A: Geocoding writes coordinates to your project as it goes β€” Geocode This/Selected/All all write immediately (you’re asked to consent to the geocoding service first); only hand edits made directly in the Coordinate panel wait for Save. To reverse geocoding changes, use Edit > Undo Plugin Updates before you close Family Historian. It only touches website files when you ask it to embed, and asks you to confirm first. It keeps no backups, so back up your website before a large embed (or be prepared to regenerate it).
Q: Someone is marked Private or Living β€” will they appear?
A: Not in a published map. Add Maps honours record privacy; see Privacy in the Reference for exactly what is and isn’t included.
Related Help

The rest of this guide is in three parts:

  • Workflows β€” step-by-step: geocoding, building a map, embedding maps in your website
  • Reference β€” the map’s features, the geocoders, map keys, privacy, and every option in full
  • Troubleshooting & FAQ β€” when a map is blank, a place won’t geocode, or a page is missed

β†’ See All Frequently Asked Questions


Plugin Add Maps

Help content on this page is owned and provided by colevalleygirl, the plugin's author, Calico Pie takes no responsibility for its content.